home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / hydraset.zip / HYDRASET.DOC next >
Text File  |  1993-02-21  |  15KB  |  269 lines
  1.      I have seen a few SysOp's on MSI HEADQUARTERS BBS (FOR WILDCAT! SYSOPS)
  2. sending messages back and fourth in the External Protocol Conference asking
  3. how they could go about setting up the NEW Bi-Directional protocol called
  4. HYDRA.  I myself am the SysOp of a WILDCAT! BBS, The It's A Free Country BBS
  5. (708) 752-0174 1200-14.4k .  I also am sort of an external protocol nut.  I
  6. like to get as many working on my BBS as is humanly possible.  So when I was
  7. reading through the messages in the conference and saw that there was a new
  8. bi-directional protocol available I had to jump up and set it up on my board.
  9.  
  10.      HYDRA is a nice protocol that looks similar to Bi-modem on the transfer
  11. screen.  It doesn't have a file transfer status bar, but does have a split
  12. screen for chat.  It is MUCH easier to set up with ANY program than Bi-modem.
  13. It sets up much the way HS-Link sets up.  It operates with WILDCAT! in the
  14. EXACT SAME METHOD as HS-Link.  The transfers FLY by, and I have yet to see
  15. an ERROR message while in a transfer.  Overall I think HYDRA is a great
  16. BEST OF BOTH WORLDS PROTOCOL.
  17.  
  18.      So enough about my BBS and about HYDRA ITSELF lets get into setting it
  19. up.  I am using WILDCAT 3.55s A Single line BBS.  If you are running a
  20. multi-node WILDCAT! BBS the setup is different but this document should be
  21. perfectly capable of guiding you in the correct direction.  After all if you
  22. can set up, run, maintain a multi-node BBS you are definitely mentally capable
  23. enough to know what parts of this set up need to be changed, and what they
  24. need to be changed to.  So I MUST point out this MAY NOT work FOR EVERYONE,
  25. but it WORKS FOR ME!
  26.  
  27.      I started by downloading HYDRA100.ARJ from MSI HQ BBS.  Then I un-packed
  28. the .ARJ and found 3 other .ARJ's inside.  HCOM_100.ARJ HSRC_100.ARJ and
  29. HYDRA001.ARJ .  I then Unpacked the HCOM_100.ARJ and it contained HYDRACFG.HTX
  30. HYDRACOM.DOC HYDRACOM.EXE HYDRACFG.EXE and LICENSE.DOC .  I then copied the
  31. two .EXE's into my D:\WC30 {substitute your drive letter of course} Directory.
  32. I then ran the HYDRACFG.EXE in my WC30 directory.  It pops up a screen that
  33. looks like this.
  34.  
  35. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  36. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  37. ░░░░░░░░╔══════════════════════════════════════════════════════════════╗░░░░░░░
  38. ░░░░░░░░║ Confirm creating new cfgfile D:\WC30\HYDRACOM.CFG [Yes/No]?  ║░░░░░░░
  39. ░░░░░░░░╚══════════════════════════════════════════════════════════════╝░░░░░░░
  40. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  41. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  42.  
  43.      Answer Y to create the configuration file.  It will then proceed to spell
  44. out  HYDRA on your screen.  When it is done with the spelling job hit ENTER.
  45. After you hit enter a MAIN MENU will appear that looks just like this.
  46.  
  47. ░Editing Default Configuration File D:\WC30\HYDRACOM.CFG
  48. ░┌───────────────────┐░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  49. ░│ General options   │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  50. ░│ Link options      │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  51. ░│ Save and exit     │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  52. ░│ Quit (don't save) │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  53. ░└───────────────────┘░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  54. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  55.      We are only concerned with two options on this menu.  The first is
  56. General options.  The second is Save and exit.  I did nothing with the
  57. Link options left them ALL at default.  Highlight General options on the menu
  58. and hit ENTER.  Then a screen like this will appear.  NOTE: The values shown
  59. in the following menu are MY ACTUAL SETTINGS! NOT DEFAULT
  60.  
  61. Editing Default Configuration File D:\WC30\HYDRACOM.CFG
  62. ░┌──────────────────┐░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  63. ░│ General options  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  64. ╔General options══════════════════════════════════════════════════════════════╗
  65. ║ Comport [1..16] (default COM1) ............ 2                               ║
  66. ║ Com-speed cpu<>modem (0=current) .......... 19200                           ║
  67. ║ Line speed modem<>modem (0=comspeed) ...... 0                               ║
  68. ║ Parity 7E1 instead of 8N1 ................. No                              ║
  69. ║ Drop DTR if carrier lost .................. No                              ║
  70. ║ Disable carrier detection ................. No                              ║
  71. ║ Don't initialize FOSSIL ................... No                              ║
  72. ║ Flow control None/Soft/Hard/Both .......... Hard                            ║
  73. ║ Log file (empty=none) .....................                                 ║
  74. ║ Level of logging 0=max, 6=min (default=2) . 2                               ║
  75. ║ Log xferinfo to DSZ logfile (empty=None) .. D:\WC30\WCWORK\NODE1\DSZ.LOG    ║
  76. ║ Disable receive bad-transfer recovery ..... No                              ║
  77. ║ Don't retain files original date/time ..... Yes                             ║
  78. ║ Path to store rcvd files (empty=curdir) ...                                 ║
  79. ║ Disable bell noise in chat feature ........ Yes                             ║
  80. ╠═════════════════════════════════════════════════════════════════════════════╣
  81. ║ [OK]                                                         Space = change ║
  82. ╚═════════════════════════════════════════════════════════════════════════════╝
  83. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  84.  
  85.      1. Comport. Set your com port number.  See HYDRA DOCS if comport is NOT
  86.         1 or 2 for details.
  87.  
  88.      2. Com speed cpu<>modem.  If you use a high speed modem and have your
  89.         comport locked this should be set to the same value as your LOCKED
  90.         comport rate in MAKEWILD.  If you are using a slower 2400 baud modem
  91.         that has no error correction you PROBABLY could set this to 0.  I am
  92.         not sure though because I have it set for high speed.
  93.  
  94.      3. Line speed modem<>modem.  This should be set at 0 since we will get
  95.         the line speed connect rate from the BATCH files and the %4 variable.
  96.  
  97.      4. Parity. If you want 7E1 set this to Yes. If you want 8N1 set to No.
  98.  
  99.      5. Drop DTR.  I have this set to No because WILDCAT! is VERY reliable
  100.         at recycling when users drop carrier and HYDRACOM.EXE exits if carrier
  101.         is dropped, provided the next question is set to No.
  102.  
  103.      6. Disable carrier detect.  If this is set to Yes HYDRA may hang and
  104.         leave your board locked up if a user drops carrier during a transfer.
  105.         I suggest setting this to NO.
  106.  
  107.      7. Don't initialize FOSSIL.  I use a single line WILDCAT! BBS so for
  108.         me this is not necessary, so Mine is set to No.  HOWEVER if you
  109.         are a multiline BBS you may need FOSSIL initialized.  I am not sure
  110.         Multi node users should see the HYDRA DOCS about this switch.
  111.  
  112.      8. Flow control.  If you use a high speed modem with a 16550 UART you
  113.         should set this to HARD.  If you use a slower 2400 baud modem without
  114.         error correction you should set this to NONE.
  115.  
  116.      9. Log file.  If you want a log file put it's name here. Otherwise leave
  117.         it blank. NOTE: DO NOT USE DSZ.LOG AS YOUR LOG NAME IN THIS QUESTION
  118.  
  119.     10. Logging level.  This applies ONLY if the log file space has a file
  120.         name in it. It is a level from 0 to 6.  0 being maximum logging and 6
  121.         being minimum logging.
  122.  
  123.     11. Log xferinfo to DSZ logfile.  IMPORTANT!! This MUST be set to your
  124.         node directory.  Mine is D:\WC30\WCWORK\NODE1\DSZ.LOG  Substitute
  125.         drive letters for yours.  ALSO you MUST ADD the FOLLOWING LINE to
  126.         either your AUTOEXEC.BAT file OR your CAT.BAT file.
  127.         SET DSZLOG=D:\WC30\WCWORK\NODE1\DSZ.LOG
  128.         substitute your drive letters of course.
  129.  
  130.     12. Disable receive bad-transfer recovery.  I have this set to NO so that
  131.         there WILL be a CRASH RECOVERY ATTEMPT MADE.  If you want to disable
  132.         crash recovery answer YES to this question.
  133.  
  134.     13. Don't retain files original date/time.  I set this to YES so that the
  135.         CURRENT time at the transfer is put on the file.  If you want to
  136.         retain the original DATE/TIME STAMP set this to NO.
  137.  
  138.     14. Path to store recvd files.  Leave this blank we will specify a place
  139.         for received files in the batch files.
  140.  
  141.     15. Disable bell noise in chat feature.  I set this to YES so if someone
  142.         in a transfer at 3 A.M decides they want to chat with me the bell
  143.         will not wake me up.
  144.  
  145.      When you finish answering the questions highlight OK in the bottom left
  146. corner of the screen and hit enter.  You will then return to the MAIN MENU.
  147. At the main menu highlight the Save and exit option and hit enter.  Your
  148. HYDRACOM.CFG file will then be written, and HYDRACFG.EXE will exit.
  149.  
  150.      Next is batch files.  I have enclosed MY batch files in with the
  151. SETHYDRA.ZIP I have uploaded to MSI.  I also have included them into this doc
  152. in case the ones are missing from the .ZIP  My batch files are as follows.
  153.  
  154. My HYDRA UPLOAD batch file is called HYDRUP.BAT and looks like this.
  155. ---------------------------------------
  156.  
  157. HYDRACOM LINE %4 GET
  158.  
  159. ---------------------------------------
  160. EXPLANATION!
  161.  
  162. HYDRACOM LINE %4 GET
  163. |______| |_____| |_|
  164.    |        |    |
  165.    |        |    |______ Specifies RECEIVE ONLY MODE
  166.    |        |
  167.    |        |___________ Specifies modem connect rate
  168.    |
  169.    |____________________ Calls HYDRACOM.EXE protocol driver
  170.  
  171. My HYDRA DOWNLOAD batch file is called HYDRDOWN.BAT and is more complicated,
  172. it looks like this.
  173. ---------------------------------------
  174.  
  175. ECHO >TRANSFER.BAD
  176. HYDRACOM LINE %4 RECEIVE D:\WC30\WCWORK\NODE1\EP SEND %5
  177.  
  178. ---------------------------------------
  179. EXPLANATION!
  180.  
  181. LINE 1----> ECHO >TRANSFER.BAD
  182.             |________________|
  183.              |
  184.              |______Creates a TRANSFER.BAD file so WILDCAT! can tell if HYDRA
  185.                     exited without transferring ANY files.  If you do not
  186.                     include this line THE CALLER WILL BE CHARGED WITH THE FILE
  187.                     DOWNLOAD OR CREDITED WITH THE UPLOAD EVEN IF THE TRANSFER
  188.                     FAILS.  It is deleted by WILDCAT! when done.
  189.  
  190. LINE 2----> HYDRACOM LINE %4 RECEIVE D:\WC30\WCWORK\NODE1\EP SEND %5
  191.             |______| |_____| |_____________________________| |_____|
  192.                |        |    |                               |
  193.                |        |    |                               |___Transmit file
  194.                |        |    |                                   OR @FILES.LST
  195.                |        |    |
  196.                |        |    |_____ Specifies RECEIVE files IF ANY and place
  197.                |        |           them in the EXTERNAL PROTOCOL DIRECTORY
  198.                |        |           SUBSTITUTE YOUR DRIVE LETTER
  199.                |        |
  200.                |        |__________ Specifies the modem connect rate
  201.                |
  202.                |___________________ Calls HYDRACOM.EXE protocol driver
  203.  
  204.      WILDCAT! comes with a utility called TIMEOUT.EXE that drops users offline
  205. during external protocols if they EXCEED their time.  If you want to use
  206. TIMEOUT with your HYDRACOM BATCH files add TIMEOUT -M%3  and TIMEOUT -U
  207. BEFORE AND AFTER the HYDRACOM command line respectively.
  208.  
  209.      Next is MAKEWILD SETUP.  Run MAKEWILD and go into external protocol setup
  210. by highlighting it from the menu.  Add a letter to access HYDRA.  I used D.
  211. Then in the name category put in HYDRA.  Then specify the names of your upload
  212. and download batch files.  Mine are HYDRUP.BAT and HYDRDOWN.BAT .  Specify
  213. Y in the batch category.  Mine looks like this.
  214.  
  215.    Ltr         Name           Up  .BAT            Down  .BAT        Batch
  216.     -       ----------      ---------------     ---------------       -
  217.  
  218.     D       HYDRA           HYDRUP.BAT          HYDRDOWN.BAT          Y
  219.  
  220.      Save your changes in MAKEWILD and exit.
  221.  
  222.      LASTLY.  DOUBLE CHECK YOUR WORK!!
  223.  
  224.        1. Make sure the following files exist in your WC30 directory
  225.                                    HYDRACOM.EXE
  226.                                    HYDRACOM.CFG
  227.                                    HYDRUP.BAT
  228.                                    HYDRDOWN.BAT
  229.  
  230.        2. Check your CAT.BAT AND AUTOEXEC.BAT files and make SURE that
  231.           SET DSZLOG=D:\WC30\WCWORK\NODE1\DSZ.LOG
  232.           is specified in ONE of them.  SUBSTITUTE DRIVE LETTERS OF COURSE.
  233.  
  234.        3. IF all looks OK reboot your system and have someone call in and
  235.           test it out.  The HYDRA DOCS explain how to set it up with MANY
  236.           different comm programs. And I know for a fact that the setup
  237.           included for QMODEM in their docs works great.
  238.  
  239.      If you are a multi node system you should only use this document as a
  240. guide toward a good setup. The only differences I could think of have been
  241. outlined in this doc, but I AM NOT A MULTI LINE SYSOP so I may have missed
  242. something.
  243.  
  244.      Anyone needing assistance with this document can reach me on the
  245. MSI HQ BBS or can call My BBS, The It's A Free Country BBS, at (708) 752-0174
  246. also if you just want to leave me a note telling me if this document helped
  247. you set up HYDRA or just confused you, I would be happy to hear from you no
  248. matter WHAT you have to say about it.  I hope I helped you fellow external
  249. protocol nuts out.
  250.  
  251. SPECIAL THANKS:  I would like to thank my CoSysOp Mark Seidler (VIPER)
  252.                  for his MANY hours of external protocol testing even though
  253.                  HE HATES IT!  It takes a REAL friend do do things they don't
  254.                  like to do just to make the BBS more versatile. THANKS MARK!
  255.  
  256.                  I would also like to thank Mike Wilson the SysOp Of another
  257.                  WILDCAT! 3.55s BBS called The Great Northern BBS at
  258.                  (708) 632-0884 for offering to help me test external
  259.                  protocols when My CoSysOp doesn't feel up to it.
  260.  
  261.  
  262.                                     Sincerely,
  263.                                           Nick Piel (COBRA)
  264.                                  SysOp: The It's A Free Country BBS
  265.                                         (708) 752-0174 14.4k
  266.                                               PO BOX 21
  267.                                          Winfield, Il. 60190
  268.  
  269. P.S.  TTFN   (Ta Ta For Now)